home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Controls / Visual Basic Controls.iso / vbcontrol / homeseex / readme.txt < prev    next >
Text File  |  1999-06-08  |  3KB  |  83 lines
  1. ActiveX Control for the CM17A readme file
  2.  
  3. Visit http://www.keware.com for updates to this control
  4.  
  5. Control Version 1.0.0 6/8/99
  6. _____________________________
  7.  
  8. Thank you for your interest in our ActiveX Control for the CM17A FireCracker.
  9.  
  10. This control includes source and distribution is unlimited. See
  11. the license file for more information.
  12.  
  13. To install the control, simple run the setup file: Setupcm17.exe
  14.  
  15. To test the control, load and run the sample application that is located
  16. in the install directory under "INSTALLDIR\Keware CM17A\sample".
  17.  
  18. The source to the control is located in:
  19.  
  20. INSTALLDIR\Keware CM17A\src
  21.  
  22.  
  23. You can contact Keware support via E-mail at: support@keware.com
  24.  
  25. Support for this control is limited as it is a FREE product.
  26.  
  27. Good Luck on your Home Automation endeavors!
  28.  
  29. Control Documentation
  30. _____________________________
  31.  
  32. Note that the CM17A FireCracker module only supports the following
  33. X10 commands:
  34.  
  35. ON
  36. OFF
  37. DIM
  38. BRIGHT
  39.  
  40. The control has been tested with Visual Basic version 5. It will appear in the components
  41. list as:
  42.  
  43. "Keware CM17A Control"
  44.  
  45. The control supports the following properties:
  46.  
  47. comport as integer
  48.  
  49. This will set the communications port that the CM17A is connected to. This
  50. must be set before the "Init" method is invoked.
  51.  
  52. The control supports the following methods:
  53.  
  54. Init()
  55.  
  56. This will open the communications port that was set with the "comport" property.
  57.  
  58. It will return 0 if successful or an error code that is returned by the MSCOMM32 OCX control.
  59.  
  60. ResetCom()
  61.  
  62. This will disconnect the control from the communications port. This is useful if the CM17A is
  63. connected to a com port that is shared with another device. You can call "Init()" to open the com
  64. port, then call "Exec()" to send a command, then call "ResetCom()" to release the com port. Note that
  65. you should wait a few seconds after sending X10 commands using "Exec()" before calling "ResetCom" to 
  66. allow communications to complete.
  67.  
  68. Exec(housecode As String, devicecode As String, command As Integer, Optional brightness As Integer)
  69.  
  70. This will send an X10 command to the CM17A. The parameters are:
  71.  
  72. housecode: the housecode the device is on like "A"
  73.  
  74. devicecode: the unit number of the device like "1". You cannot use multiple device numbers here.
  75.  
  76. command: the X10 command. 2=ON 3=OFF 4=DIM 5=BRIGHT
  77.  
  78. brightness: this is optional and only valid for dim and bright commands. It is an integer in the range
  79. of 0-100. Note that the CM17A changes brightness in steps. It only supports 8 dim levels. One dim=12%.
  80. Setting the brightness to 50% will send 4 dims and the light will step 4 times.
  81.  
  82.  
  83.